package com.zhentao.service;


import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zhentao.dto.QueryTemplateDto;
import com.zhentao.pojo.QueryTemplate;

import java.util.List;

/**
 * 查询模板服务接口
 * 根据业务流程需求设计，支持查询条件模板的保存和应用，方便下一次使用
 */
public interface QueryTemplateService extends IService<QueryTemplate> {
    
    /**
     * 保存查询模板
     * 根据业务流程：支持保存和应用查询条件模板，方便下一次使用
     * 
     * @param templateDto 模板信息
     * @return 保存后的模板ID
     */
    Long saveTemplate(QueryTemplateDto templateDto);
    
    /**
     * 更新查询模板
     * 
     * @param templateDto 模板信息
     * @return 是否更新成功
     */
    boolean updateTemplate(QueryTemplateDto templateDto);
    
    /**
     * 删除查询模板
     * 
     * @param templateId 模板ID
     * @param userAccount 用户账号
     * @return 是否删除成功
     */
    boolean deleteTemplate(Long templateId, String userAccount);
    
    /**
     * 根据模板ID获取模板详情
     * 
     * @param templateId 模板ID
     * @return 模板详情
     */
    QueryTemplateDto getTemplateById(Long templateId);
    
    /**
     * 根据查询类型获取用户模板列表
     * 根据业务流程：支持按查询类型、用户账号、关区代码筛选模板
     * 
     * @param queryType 查询类型
     * @param userAccount 用户账号
     * @param customsCode 关区代码
     * @return 模板列表
     */
    List<QueryTemplateDto> getTemplatesByType(String queryType, String userAccount, String customsCode);
    
    /**
     * 分页查询模板列表
     * 
     * @param queryType 查询类型
     * @param userAccount 用户账号
     * @param customsCode 关区代码
     * @param pageNum 页码
     * @param pageSize 页大小
     * @return 分页结果
     */
    IPage<QueryTemplateDto> getTemplatePage(String queryType, String userAccount, String customsCode, 
                                          Integer pageNum, Integer pageSize);
    
    /**
     * 应用模板进行查询
     * 根据业务流程：支持应用查询条件模板
     * 
     * @param templateId 模板ID
     * @return 查询条件
     */
    QueryTemplateDto applyTemplate(Long templateId);
    
    /**
     * 复制模板
     * 
     * @param templateId 原模板ID
     * @param newTemplateName 新模板名称
     * @param userAccount 用户账号
     * @return 新模板ID
     */
    Long copyTemplate(Long templateId, String newTemplateName, String userAccount);
    
    /**
     * 共享模板
     * 
     * @param templateId 模板ID
     * @param userAccount 用户账号
     * @return 是否共享成功
     */
    boolean shareTemplate(Long templateId, String userAccount);
    
    /**
     * 获取热门模板
     * 
     * @param queryType 查询类型
     * @param limit 限制数量
     * @return 热门模板列表
     */
    List<QueryTemplateDto> getPopularTemplates(String queryType, Integer limit);
    
    /**
     * 增加模板使用次数
     * 
     * @param templateId 模板ID
     */
    void incrementUseCount(Long templateId);
}
